rotate: Add missing documentation

diff --git a/gtk/gtkgesturerotate.c b/gtk/gtkgesturerotate.c
index 74edda487ffdeee2349cde1a1d7e3a285dcf0865..5dd63f72316f29ab02c68cdaecff40cc48406a5c 100644 (file)
--- a/gtk/gtkgesturerotate.c
+++ b/gtk/gtkgesturerotate.c
@@ -17,6 +17,18 @@
  *
  * Author(s): Carlos Garnacho <carlosg@gnome.org>
  */
+
+/**
+ * SECTION:gtkgesturerotate
+ * @Short_description: Rotate gesture
+ * @Title: GtkGestureRotate
+ * @See_also: #GtkGestureZoom
+ *
+ * #GtkGestureRotate is a #GtkGesture implementation able to recognize
+ * 2-finger rotations, whenever the angle between both handled sequences
+ * changes, the #GtkGestureRotate:angle-changed signal is emitted.
+ */
+
 #include "config.h"
 #include <math.h>
 #include <gtk/gtkgesturerotate.h>
@@ -142,7 +154,12 @@ gtk_gesture_rotate_class_init (GtkGestureRotateClass *klass)
    * GtkGestureRotate::angle-changed:
    * @gesture: the object on which the signal is emitted
    * @angle: Current angle in radians
-   * @angle_delta: Difference with the starting angle in radians
+   * @angle_delta: Difference with the starting angle, in radians
+   *
+   * This signal is emitted when the angle between both tracked points
+   * changes.
+   *
+   * Since: 3.14
    */
   signals[ANGLE_CHANGED] =
     g_signal_new ("angle-changed",